On-Premise Upgrade — Detailed Walk Through

This guide provides step-by-step instructions for upgrading your EMS platform and applications, especially if you have missed multiple patches. Follow these steps to ensure a successful upgrade.

Uninstall Existing EMS Applications

1. Uninstall EMSPlatformServices and all EMS-related applications from your web server.

2. Preserve any custom CSS or HTML configurations.

3. Re-add these configurations with the latest version of each EMS application after updating system requirements.

Upgrade Considerations

Customize Labels, Messages, and Images in the EMS Room Sign App

Customize EMS Web App

Review System Requirements

1. Refer to the official EMS SystemReq 225 to ensure all prerequisites are met on the Application server before reinstalling EMS components.

2. Confirm that all prerequisites are installed on the Application server before EMS components are re-installed.

Install Required Frameworks

1. Install the .NET 8.0 Windows Core Hosting Bundle on the Web/Application server. Do not uninstall the current version.

2. Download and install ASP.NET Core 8.0 Runtime.

3. Ensure .NET Framework 4.8 is installed. Download .NET Framework 4.8 if needed.

Download ASP.NET Core 8.0 Runtime (v8.0.18) - Windows Hosting Bundle Installer

Download .NET Framework 4.8 | .NET

Apply SQL EMS Patches

1. Download all EMS Patches and Applications from the EMS Software Customer Login Portal.

   1. Navigate to the Software and Docs Library / Software upgrades and patches.

      

   2. Select the EMS Upgrade Toolkit for multi-version upgrading.

      

   3. Download the PDF and the Patches from the EMS Upgrade Toolkit.

      

2. Install patches in the following order:

• 220.2

• 220.3

• 221.1

• 221.3

• 221.4

• 223.1

• 223.3

• 224.1

• 224.3

• 224.4

• 225.1

3. Request the patch zip file from EMS support if needed.

• https://access.accruent.com/

• [email protected]

Run EMS Environment Utility (for EMS 222.3 and later)

1. Run the utility on a server with direct access to the SQL server using a Microsoft SQL Server (SA) level account.

2. Navigate to the Environment Utility directory.

3. Run EmsEnvironmentConfigTool.exe.

4. Enter the required information and click OK.

5. Close the application after a success popup appears.

Install EMS Platform Services

1. Install EMS Platform Services.

2. Verify it’s running by navigating to its URL status page.

Install EMS Desktop Web Deploy

1. Install EMS Desktop Web Deploy to create a link and landing page for Expert Users to install the Desktop Client (DTC).

2. Choose HTTP or HTTPS during setup.

3. If HTTPS is used, visit https://yourserver.com/emsdesktopwebdeploy to install.

Install EMS Web App

1. Log in to the Platform Services Admin Portal using a web user account with an Admin Security Template.

2. Navigate to Integrations → Clients → EMS Web Application.

3. Click Reset Secret and copy the new code. Save this for later for step 7.

4. Retrieve the EMS Web App installer and run it. By default, this installs into C:\Inetpub\wwwroot\EmsWebApp.

5. Navigate to the EmsWebApp folder to locate the web.config file.

6. Edit the web.config file. You may need to change permissions to allow editing.

7. Search for and replace pasteSecretHere with the new code copied earlier in step 3.

8. Save and close the file.

Install Remaining EMS Applications

1. Install any remaining EMS modules included in your license and services.

If Using EMS Kiosk

1. Log in to the Platform Services Admin Portal using a web user account with an Admin Security Template.

2. Navigate to Integrations → Clients → EMS Kiosk.

3. Click Reset Secret and copy the new code. Save this for later.

4. Retrieve the EMS Kiosk installer and run it. By default, this installs into C:\Inetpub\wwwroot\EmsKiosk.

5. Navigate to the EmsKiosk folder to locate the appsettings.json file.

6. Update the appsettings.json file with the new secret.

 

After these steps, your system should be up-to-date.